Funzioni di ricavo

Utilizzando le funzioni di ricavo (Get) negli script per il controllo e la prevenzione degli errori è possibile reperire informazioni sullo stato del file di database o degli elementi al suo interno, o su un'azione in corso di esecuzione.

Se si utilizzano le funzioni di ricavo nei campi Calcolo definiti, i risultati del calcolo devono essere non memorizzati, altrimenti il calcolo non verrà aggiornato quando lo stato cambia.

Per accedere alla lista di funzioni di ricavo, nella finestra di dialogo Specifica il calcolo, scegliere Mostra: tutte le funzioni per tipo oppure Mostra: Funzioni di ricavo. Quando si sceglie Mostra: tutte le funzioni per nome, si vede solo Get(flag).

Nota  Per informazioni su come eseguire script in ambienti client/server e peer-to-peer vedere Risoluzione di calcoli su una macchina host.

Per maggiori dettagli, fare clic sul nome di una funzione.

Funzione

Restituisce

Funzione Get(NomeAccount)

L'account utilizzato per il file di database attivo.

Funzione Get(ContenutoCampoAttivo)

Il contenuto del campo in cui è posizionato il cursore.

Funzione Get(NomeCampoAttivo)

Il nome del campo su cui è posizionato il cursore.

Funzione Get(NomeTabellaCampoAttivo)

Il nome della tabella che contiene il campo attivo (il campo su cui è posizionato il cursore).

Funzione Get(TastiModificatoreAttivo)

Un numero che rappresenta i tasti di modifica (ad esempio Maiusc) premuti.

Funzione Get(NumeroRipetizioneAttiva)

Un numero che rappresenta la ripetizione corrente (attiva) di un campo multiplo.

Funzione Get(DimensioniSelezioneAttiva)

Un numero che rappresenta quanti caratteri sono selezionati.

Funzione Get(InizioSelezioneAttiva)

Un numero che rappresenta il carattere di inizio del testo selezionato.

Funzione Get(ConsentiStatoInterruzione)

Un valore booleano che rappresenta lo stato corrente dell'istruzione di script Consenti interruzione utente.

Funzione Get(LinguaApplicazione)

Testo che rappresenta la lingua corrente dell'applicazione (ad esempio Italiano).

Funzione Get(VersioneApplicazione)

Testo che rappresenta la versione dell'applicazione FileMaker Pro.

Funzione Get(NumeroRipetizioneCalcolo)

Un numero che rappresenta la ripetizione del campo Calcolo che si sta calcolando.

Funzione Get(DataCorrente)

La data corrente in base al calendario di sistema.

Funzione Get(IndicatoreDataOraHostCorrente)

La data e l'ora corrente dell'host (approssimata al secondo più vicino) in base all'orologio di sistema).

Funzione Get(OraCorrente)

L'ora corrente (approssimata al secondo più vicino) secondo l'orologio di sistema.

Funzione Get(IndicatoreDataOraCorrente)

La data e l'ora corrente (approssimata al secondo più vicino) in base all'orologio di sistema.

Funzione Get(StatoCatturaErrori)

Un valore booleano che rappresenta lo stato dell'istruzione di script Imposta cattura errori.

Funzione Get(PrivilegiEstesi)

Una lista di parole chiave per i privilegi estesi attivati, separate da ritorni a capo

Funzione Get(NomeFile)

Il nome del file di database correntemente attivo.

Funzione Get(PercorsoFile)

Il percorso completo che indica la posizione del file.

Funzione Get(DimensioniFile)

Le dimensioni (in byte) del file di database correntemente attivo.

Funzione Get(ContoTrovati)

Un numero che rappresenta il numero di record nel gruppo trovato corrente.

Funzione Get(ColoreAltoContrasto)

Il nome dello schema del colore ad alto contrasto predefinito corrente se nella finestra di dialogo Accesso facilitato del sistema operativo Windows è selezionato Usa Contrasto elevato.

Funzione Get(StatoAltoContrasto)

Un valore booleano che rappresenta lo stato della casella di controllo Usa Contrasto elevato nella finestra di dialogo Accesso facilitato.

Funzione Get(NomeHost)

Il nome registrato nel computer che funge da host per il file di database.

Funzione Get(UltimoErrore)

Un numero che rappresenta l'errore, se presente, nell'ultima istruzione di script eseguita.

Funzione Get(SceltaUltimoMessaggio)

Un numero corrispondente al pulsante su cui si fa clic in un messaggio di avviso visualizzato dall'istruzione di script Mostra finestra personalizz.

Funzione Get(UltimoErroreODBC)

Una stringa che mostra lo stato dell'errore pubblicato dagli standard ODBC, in base agli standard ISO/IEF.

Funzione Get(AccessoFormato)

Un numero che corrisponde ai privilegi di accesso del formato assegnati tramite la finestra di dialogo Definisci Account e Privilegi.

Funzione Get(ContoFormati)

Il numero totale di formati nel file di database.

Funzione Get(NomeFormato)

Il nome del formato correntemente visualizzato.

Funzione Get(NumeroFormato)

Il numero del formato correntemente visualizzato, in base alla lista nella finestra di dialogo Imposta ordine dei formati.

Funzione Get(NomeTabellaFormato)

Il nome della tabella da cui il formato sta visualizzando record.

Funzione Get(StatoVistaFormato)

Informazioni sul modo di visualizzazione corrente del file di database.

Funzione Get(StatoMultiUtente)

Un numero che rappresenta lo stato multiutente corrente del file di database.

Funzione Get(ProtocolloRete)

Il nome del protocollo di rete che FileMaker Pro utilizza su questa macchina.

Funzione Get(NumeroPagina)

Un numero che rappresenta la pagina correntemente in fase di stampa o visualizzata in anteprima.

Funzione Get(NumeroRigaPortale)

Il numero della riga del portale correntemente selezionata.

Funzione Get(NomeStampante)

Una stringa di testo che identifica il nome della stampante predefinita.

Funzione Get(NomeSetPrivilegi)

Il nome del set di privilegi usato dall'utente corrente.

Funzione Get(AccessoRecord)

Un numero che indica i privilegi di accesso del record corrente.

Funzione Get(IDRecord)

L'ID univoco del record corrente.

Funzione Get(ContoModificaRecord)

Il numero totale di modifiche del record corrente che è stato salvato.

Funzione Get(NumeroRecord)

Il numero del record corrente nel gruppo trovato corrente.

Funzione Get(ContoRichieste)

Il numero totale di richieste di ricerca definito correntemente per la tabella corrente.

Funzione Get(ProfSchermo)

Il numero di bit necessari per rappresentare il colore o il livello di grigio di un pixel sullo schermo principale.

Funzione Get(AltSchermo)

Il numero di pixel visualizzati verticalmente sullo schermo in cui è aperta la finestra del file corrente.

Funzione Get(LarghSchermo)

Il numero di pixel visualizzati orizzontalmente sullo schermo in cui è aperta la finestra del file corrente.

Funzione Get(NomeScript)

Il nome dello script correntemente in esecuzione (o in pausa).

Funzione Get(ParametroScript)

Il parametro dello script passato allo script corrente.

Funzione Get(StatoOrdinamento)

Un valore booleano che rappresenta l'ordinamento corrente.

Funzione Get(AreaStatoCorrente)

Un numero che indica se l' area di stato è nascosta, bloccata o presenta entrambe le condizioni.

Funzione Get(IndirizzoIPSistema)

Gli indirizzi IP di tutte le macchine connesse alla scheda NIC (Network Interface Controller).

Funzione Get(LinguaSistema)

La lingua attualmente impostata sul sistema corrente.

Funzione Get(IndirizzoNICSistema)

Gli indirizzi hardware di tutte le schede Network Interface Controller collegate alla macchina.

Funzione Get(PiattaformaSistema)

Un numero che indica la piattaforma corrente.

Funzione Get(VersioneSistema)

La versione del sistema operativo della macchina su cui si sta eseguendo la funzione.

Funzione Get(ContoRecordTotale)

Il numero totale di record nella tabella corrente.

Funzione Get(ContoUtenti)

Il numero di utenti che accedono correntemente al file.

Funzione Get(NomeUtente)

Il nome dell'utente FileMaker Pro, come specificato nella scheda Generale della finestra di dialogo Preferenze.

Funzione Get(AltezzaContenutoFinestra)

Un numero che rappresenta l'altezza, in pixel, dell'area del contenuto.

Funzione Get(LarghezzaContenutoFinestra)

Un numero che rappresenta la larghezza, in pixel, dell'area del contenuto.

Funzione Get(AltezzaDesktopFinestra)

Un numero che rappresenta l'altezza, in pixel, dello spazio sul desktop.

Funzione Get(LarghezzaDesktopFinestra)

Un numero che rappresenta la larghezza, in pixel, dello spazio sul desktop.

Funzione Get(AltFinestra)

Un numero che rappresenta l'altezza, in pixel, della finestra corrente del file a cui è applicato il calcolo.

Funzione Get(SinistraFinestra)

Un numero che rappresenta la distanza orizzontale, in pixel, del bordo esterno della finestra corrente rispetto al bordo più a sinistra della schermata.

Funzione Get(ModoFinestra)

Un numero che indica se FileMaker Pro si trova in Modo Usa, Modo Trova, Modo Anteprima, o se sta stampando al momento della valutazione della funzione.

Funzione Get(NomeFinestra)

Il nome della finestra corrente del file a cui è applicato il calcolo.

Funzione Get(AltoFinestra)

Un numero che rappresenta la distanza verticale, in pixel, del bordo esterno della finestra corrente rispetto al bordo inferiore della barra dei menu o alla barra degli strumenti.

Funzione Get(FinestraVisibile)

Un valore booleano che indica se la finestra corrente è visibile o no.

Funzione Get(LarghFinestra)

Un numero che rappresenta la larghezza, in pixel, della finestra corrente del file a cui è applicato il calcolo.

Esempio di funzioni di ricavo

Questo script utilizza la funzione Get(DataCorrente) per controllare ciascun record nel gruppo trovato per vedere se un account è scaduto. Se l'account è scaduto, lo script visualizza un messaggio e richiede all'utente di fare clic su un pulsante Ignora, Invia lettera, o Invia posta (impostati attraverso l'istruzione di script Mostra finestra personalizz.). Lo script cattura la risposta dell'utente usando Get(SceltaUltimoMessaggio). Quindi, in base alla risposta dell'utente, lo script effettua un'operazione: annulla il resto dello script, stampa una lettera "pagamento in ritardo" o invia un'e-mail all'account associato.

Passa al modo Usa [ ]

Vai al formato ["NomeFormato"]

Vai a Record/richiesta/pagina [Primo]

Loop

  If [NomeDatabase::Data < Get(DataCorrente)-30]

    Mostra finestra personalizz. ["30 o più giorni di ritardo"]

    If [Get(SceltaUltimoMessaggio) = 1]

      Interrompi lo script

    Else If [Get(SceltaUltimo Messaggio) = 2]

      Vai al formato ["Ultimo avviso"]

      Stampa []

    Else

      Invia posta [A:NomeDatabase::Client;Oggetto: "Avviso"; Messaggio:"Effettuare il pagamento!"]

    End If

  End If

  Vai al formato ["NomeFormato"]

  Vai a Record/Richiesta/Pagina [Esci dopo l'ultimo;Successivo]

End Loop

Vai al formato [formato originale]